home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Mission 3
/
Mission 3.zip
/
Mission 3.iso
/
tools
/
facevalu
/
docu
/
face_eng.ref
(
.txt
)
< prev
next >
Wrap
Atari ST Guide REF Links
|
1998-04-25
|
6KB
|
304 lines
FACE_ENG
%Programdocumentation for faceVALUE
Title
Contents
Introduction
Tutorial
faceVALUE principles
faceVALUE program dialogs
Menu bar
Dialog 'Main'
User window flags
About Face Value
System alerts
System requirements
Rsc information
Parameters-Dialog
Error dialog
%Create a program from the RSC file
Files produced by faceVALUE
Structure of the LST file
Updating a project
'Starting Face Value with commandline
Understanding the RSC file
Trees
Mandatory trees
Conditional trees
Optional Trees
Dialog trees
User-window trees
Objects
Programming with faceVALUE
!How the faceVALUE engine works
"How to write clean GEM programs
Hi ho, off to work we go
Window iconification
Working with windows
&The RSC-file, objects and variables
The ASCII-table dialog
/How to use GDOS fonts and xFSL-fontselectors
Getting keyboard-input
The error-routine
%'Wrinkles' - modules for faceVALUE
The name and the goal
Rules for wrinkles
Documentation
Face Value 2.0 flags
Reference
Reference - The resource file
Reserved dialog names
Sorting your dialogs
Menu- and Dialog-Trees
Menu - Extended type: 0
System - Extended type: 1
Background - Extended type: 2
Toolstrip - Extended type: 3
Toolbar - Extended type: 4
!ASCII-table - Extended type: 5
Mouseforms - Extended type: 6
Desktop - Extended type: 7
Progress - Extended type: 8
Busydialog - Extended type: 9
Iconify - Extended type: 10
PopUps - Extended type: 11
Alert - Extended type: 12
"Alert icons - Extended type: 13
$Alert strings - Extended type: 14
ListBox - Extended type: 15
$Animated icon - Extended type: 16
Code - Extended type: 17
'Non-modal dialog - Extended type: 18
'Prg.modal dialog - Extended type: 19
Toolbox - Extended type: 20
Changes to Dialogs
&Dialogs with *no* window attributes
Foldable Dialogs
Desktop-Dialog
Changed: System-Dialog
Standard objects
Boxtext
Image
Progdef
Button
Boxchar
String
Ftext
Fboxtext
(Menu)title
Cicon
Face Value special objects
Frame
Niceline
Underlined text
Checkbox
Round radiobutton
NumberScroller
RadioTextPopup
MenuTextPopup
RadioImagePopup
MenuImagePopup
RadioListbox
CheckListbox
MenuListbox
Shortcut button
Shortcut string
ShortcutIcon
PointForward
Shortcut boxchar
PointBack
Help button
Help menu item
AnimatedIcon
AutoCompress Icon/Image
CloserButton
QuitApp
New objects
Sizer Object
Toolbox popup radiobuttons
Movable objects
Drag & drop objects
Objects with new features
/Listbox: Autolocator added (hi, Manfred! ;-)
Tear-Off Popups
Animated objects
Animated icons
Object state
Selected - OB_STATE bit 0
Crossed - OB_STATE bit 1
Checked - OB_STATE bit 2
Disabled - OB_STATE bit 3
Outlined - OB_STATE bit 4
Shadowed - OB_STATE bit 5
Extended object states:
Object flags
Selectable - OB_FLAGS bit 0
Default - OB_FLAGS bit 1
Exit - OB_FLAGS bit 2
Editable - OB_FLAGS bit 3
Rbutton - OB_FLAGS bit 4
Lastob - OB_FLAGS bit 5
Touchexit - OB_FLAGS bit 6
Hidetree - OB_FLAGS bit 7
Indirect - OB_FLAGS bit 8
Extended object flags
Shortcuts in menu-entries
Reference - Programming
Global
Global variables list
window_array&(index&,x&)
window_tree%(index&,x&)
Reference - User routines
Always
user_var_index
user_rsc_var_init
user_rsc_interact
user_rsc_draw_extra
user_on_open
user_on_exit
user_quit_ok
user_systemcheck
user_gem_messages
user_win_close_all
Userwindows
user_window_content
user_mouse
user_keyb
user_win_close_ok
User routines drag & drop
user_dragdrop_init
user_dragdrop_path
user_dragdrop_accept
user_dragdrop_loaddata
'Reference - Callable system routines
Using windows
win_open
win_get_workarea
win_set_infoline
win_set_slidersize
win_set_vslider
win_set_hslider
win_change_size
win_keyb_scroll
win_open_dialog
win_close_all
win_close
win_set_title
win_get_index
win_send_redraw
win_modal_enq
Iconification
win_iconify
win_iconify_all
win_uniconify
win_uniconify_all
Window cycling
win_cycle
Blitting image bitmaps
vdi_bitblt
&Offscreen bitmaps (mono, NVDI/EdDI)
offscreen_open
offscreen_close
Allocate global memory
mxalloc_global
Fileselector support
selectric_load$
selectric_check
fileselector$
0Getting information from the operating system
appl_xgetinfo
vq_extnd
vq_vgdos
get_cookie
clip_bootdrive$
Alerts
alert_standard
alert_wind
Blocking the screen/system
aes_screen_lock
aes_screen_unlock
aes_clear_buffers
Progress bar
progress_open
progress_update
progress_close
Busy dialog
busy_open
busy_update
busy_close
Virtual workstations
v_opnvwk
v_clsvwk
Mouse
mouse_wait
mouse_form
mouse_busy
Load and save mono IMG
img_load
img_save
#Sending GEM messages to yourself
aes_internal_message
Calling ST-Guide
call_st_guide
Installing a custom desktop
desktop_new
desktop_restore
Using the GEM clipboard
clip_write$
clip_read$
Working with objects
rsrc_setup_tree
xrsrc_gaddr
rsc_ob_flags
rsc_ob_state
rsc_ob_check
rsc_ob_hide
rsc_ob_disable
rsc_free_string$
rsc_free_image_vrt_cpyfm
rsc_free_image
rsc_set_new_menu
rsc_get_code_adr
rsc_ob_draw
rsc_ob_xywh
rsc_set_text
rsc_get_text$
rsc_disable_menutitle
rsc_find_menutitle
set_cursor
Read the keyboard state
aes_get_kstate
Drag & drop protocol
fread
dd_read_args$
GDOS and xFSL support
vdi_load_fonts
vdi_unload_fonts
vst_alignment
EVNT_MULTI loop
evnt_multi_loop
faceVALUE Converter 1.0
RSC library
Example programs
EX.RSC:
IMG_VIEW.RSC
faceVALUE history
#Changes to faceVALUE version 1.1
Additions
Changes, Improvements
Bug fixes
#Changes to faceVALUE version 2.0
Changes after Version 2.0
06.04.98 PL1 (HH)
07.04.1998 PL2 (HH)
08.04.1998 PL3 (HH)
08.04.1998 PL4 (MS)
11.04.1998 PL5 (MS)
17.04.98 PL6 (HH)
18.04.98 PL6 (MS)
19.04.98 PL6 (MS)
20.04.98 PL6 (HH)
22.04.98 PL6 (MS)
24.04.98 (HH)
24.04.98 (MS)
Index